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Subject? . Operational cnanges for MR 4.0 


INTRODUCTION 


A new version of the Muitics storage system has been 
instalied with system MR 4.04 This version of tne system will be 
much more reliable and be able to handle more storage. 


Definitions 
Several terms are used often in describing the new storage 
System*s operation: 


physical volume | A disk pack. Sometimes we speak of the 

. combination of pack and disk drive as the 
volumee . 

volume label . Each physical volume has a tabei which 


identifies it to the system. 


VToCc . Each physical volume contains a Volume 
Table of Contents (VTOC), which tists 
information about the segments on. the 
volume. 


root physical volume (RPV). The physical volume which contains 
the root directory. It also contains the 
hardcore partition. . 


partition A block of disk storage used for a special 
purposee 


hardcore partition A partition used for paging those segments 
which come in off the system tape or are 
created dguring bootload. 
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logical votume “A set of physical volumes always used 
together. 

root togical volume (RLV) The onty togicalt votume which 
contains directories. 

record “Af 4024-word contiguous block of dlske 
Each volume has Muiltics records numbered 
starting with zero to aée=maximum which 
depends on the model number of the dlsk 
pack and drive. 

sector oA 64-word block of disk. A sector is the 


Tne tera 


particular disk drives’ alt disk drives witt be Identified 


Ssmaltest addressable unlit of disk with the 
- ‘current hardwaree Each Multics record 
contains 16 sectors. Fiela engineering 


test and diagnostic programs and 


some 


other special appilcations may use sector 
addressing, obut its use is rare in normat 


operatione Since no Multlics record 
split across disk cylinders, there may 


some sectors ona disk pack which are 


Is 
de 


not 


part of any record, depending on the model 


number of the disk. 


“area™ wil! not be used any more to describe a 


subsystem name and drive number. Orive numbers start af i. 


Naloc changes 


are four new rules imposed by the new storage system? 


There 


1 


Ze 


3 


ye 


Al’ the pages of a segment are always on the same 
physical volume. In older versions of the 
supervisor, any page of a segment might be found 
on on any disk unife 


Alt segments in fhe same directory are atways In 
the same togical volume. This attribute of a 
directory is its “sons togicat votume ID™ or 
“sons_ivide™ Usually, when a directory Ils 
createds the new directory gets the same sons_tivid 
as the parent directory. A directory whose 
sons_tvld is different from its parent directory*s 


sons_!ivid is called a master directory. 


All directories are always on the root  tlogical 
volumes 


At} logical volumes are registered. The 
registration Information for a togicai volume 
inctudes tne fist of physical voiumes in the 


by 
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logical volume and the access contro! rulies for 
use of the logical volume. 


These changes mean that lf a single disk unit has a head crash It 
will be much easier to find out what segments were tftost and 
wnefner Tne system can continue fo rune Offens, efter a crashs 
the operator wiii be able to reload only those volumes whose 
contents were damagede Under the old system, any head crash was 
bound to destroy a few pages each of many directorless in the new 
System oniy those physical volumes whicn are part of the root 
fogical volume have directories on theme 


Contents of a Physicai Volume 
The contents of a physical voiume !fook ftike this? 


fow }+ Volume Label . i 


@@OBDW OGD Bae @ @ OOO Oana OBO DLASe@® BSA ee oa @e 


3 Volume Map 3 


i VTOC header and error data } 


3 i 


i = 6vToc } 
i | i 
; 3 
i Pages of segments i 
3 H 
i : i 
i Partitions (optional) ; 


Not aii volumes have partitionss and the partitions may exist 
either at the top of the pages of segments (as. shown in the 
picture), or betwean the VTOC and the pages of segments. 
Partitions must always reside completely on ae single ophysical 
volume. 
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BOS CHANGES © 


Many changes have been made to BOS-e Most of these are a 
result of the new volume organization. 


Contig Deck Changes 
The most important change in 80S Is that the old notion of a 
partition, defined by a PART cards has been replaced. 


Tne PART MULT card used to define the total space avaliable 
for Multics segmentse There is no PART MULT card under ttre new 
storage system and 80S does nof Know which volumes are to be used 
for Multics paginge Oniy Muitics has this information. 


PART cards are stili used to teil 80S about the special 
areas of the disk storase which It uses for FOUMP, and for 8905S 
itself, and to tell Multics where the FDUMP, SYSERR fog, and HC 
(hardcore) partitions are. The new format of a PART card looks 
{ike thls? 


PART <partname> <subsystem> <drive> 
Examples PART LOG DSK7 5 


This card says fhat fhe LOG partition is to reside on the volume 
mounteaq on drive % of disk subsystem OSK7. The system will 
consult the tabel of that volume to find where the records of the 
LOG partition are to residee Ouring a cotd boot, additional 
information Is specified on the PART card for any partitions to 


reside on the RPV. 


Disk subsystems used to be defined by 0191 or £191 or 
whatever cards in the CONFIG deck. These subsystems are now 
defined by the PRPH cards which ftooks tike this? 


PRPH <subsystem> <lom> <chn> <nchn> <modeli> <n1> eee 
Examptie’ PRPH DSK7 A 30 4& 400- Se 450. 2 


Ait’ aisk subsystems tnave names of the form DOSKx, x arbitrary. 
This card deseribes the OSK7 subsystem It Is connected to I0M 
As on channeis 30°33- Drives 1 through 9 are model MSUQ400 
drives, and drives 10 and i1 are modei MSU0450 drives. 


The valid model numbers are? 


181. | OSUL81 
191 033191 (same as MSUQ49Q0) 
GOGe MSUG460 
450. MSU0450 


Tne ROOT card is newe it points out the tocation of the 
root physical volume. 
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ROOT <subsystem> <drive> 
Exampie? ROOT OSK7 1 


by specifying the subsystem name and drive number. The disk unlt 
polnted to must be the same as that on the PART HC card. 


A new configuration card has been provided to specify the 
sizes of certain wired-down tables. There may be more than one 
HWTBL card; each card may specify up to 6 pairs of the form 
<id> <iength> where the ilensth Is In words. 


WIBL <Iidi> <lengthi> ee. 
Exampie?t wWTBL VTB 16024. PVT 1024. 
WIBL TTYB 2048. 


The fotiowing is a table of the valid arguments fo the WTBL card? 


id Segment Name Default Lth 
0355 dn355_data 360° 
DISK disk_seg 5006 
DST adst_seg 768. 
I068M iobm data ; 152.6 
IOMD lom_data 5326 
PRTB printer_trace_buffer — Ge 
PVT _ ovt oe 2048.6 
SYST “ £ system_trace_seg | De 
TTYB tty_ouf Oo 61446 
VTB vtoc_buffer_seg - 2048. 


The TTYB and PRT8SB cards become obsolete, and must not be usede 
If present in the CONFIG deck, they must be changed to WITBL 
cardse ; 


The SST card must be adjusted because the size of an AST 
entry has Increased from 8 words fo 12. Either the segment size 
must be increased, or the pool sizes must be decreased. For 
example, if a site ras the following SST card 


SST 360 57650 3704 110+ 10-2 


then the increase in words for the new system Is 
(57643704+110410)*4/1024, or 5 pagese An alternative woulc be fo 
decrease the sizes of the AST pools and keep the SST size 
constant. So either of the fotiowing SST cards would be 
reasonabie? 


SST 4&1 5766 3705 1106 106 
SST 360 4306 317. 104. 10. 


A new parameter IS allowed on the DEBG card, for system 
debugging use. If the parameter CRWL Ils put on the ODEBG card, 
the sysfem will reaturn to BOS on every atfempt to craw! ouf of 
ring Gs with the message 
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verlfy_lock! crawlout ston specified on debg card 


so that the system staff can take a dump. Typing GO will cause 
the system fo continue operation. Another parameter which can be 
specified on the OEBG carg is fhe OIRW fiag,y which causes 
modified directory pages to he written from core whenever a 
directory ls unlocked. Specifying this parameter Increases the 


safety of the system at some cost in increased paging. 


A new card is used when muitipte IOM*sS are used, to Indicate 
which channels can reach a disk subsystem from each IOM: 


CHNL <subsystem> <lom2> <chn2> <iom3> <chn3> eee 
Exampie? CHNL OSK7 B 24 


This card is used onty when more than one [10M Is in the 
configuration. 


To indicate tnat a group of disk units are to be used for 
user I/0 dlsk packs fhe former PRPH DISK card has been changed to 
the foliowing? 


UDSK <subsystem> <nchn> <drivei> <counti> eee 
Exampie: UOSK DSK7 2 8e 2 


This card specifies the maximum number of channels which may be 
used to support user peripheral dilsk I/0; If the channeis are 
not required for user I[/0 they are avaitable for storage system 
I/O. Up to six pairs of drive number and number of drives may be 
specifled to indicate the particular units which are to be used 
for user peripheral disk I/0. A disk drive can be used (for 
either storage system volumes or user peripheral packs; the 
System must be shut down to change the status of a drive from one 
to the ofher. 


To change the default options for all salvaging operations, 
another card is used.e 


SALV <options> 
Exampie’ SALV CNSL RBLO 


Tne foliowing options are recognized? 


CNSL Afi output via SYSERR console 

RBLD Rebulfid atl directories 

PATH Print pathname of all directorles salvaged 
DUMP Qump damaged objects 

DEBG Vebugging use only 


The CNSL option Ils used when all printers at an installation are 
downe Ali other options should be used onty at the direction of 
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the system staff. 


aample Configuration Deck 


nere is a sampie configuration deck for a smaii machine. 


CPU B 6 

MEM A 128. ON 

MEM B 128-2 ON 

IOM AQ 4 14 24 34 


CLOK 5 EST 

PRPH OSK7 A 24 4 406. 7 * NEW 

ROOT OSK7 1 * NEW 

PART 80S DSK7 1 * NEW 

PART HC DSK7 1 * NEW 

PART LOG DSK7 2 * NEW 

PART DUMP OSK7 2 * NEW 

UDSK DSK7 17 4 * NEW 

BULK 0 512. 1 2 

PAGE BULK 0 1000 

SST 306 220. 110+ 40. 6. 

INT 230 234 232 233 22 223 

OPTY OC_ 

SCHD 400000 10 10 160 

TCD 6. 88. 1966 192. 

TBLS STR 6 Se : 
WTBL TTYB 2048. * REPLACES TTYB 2 
PRPH OPC A 20 IBM 4Q. : 
PRPH PRTA A 30 1600+ 600. 136. 
PRPH TAPE A 22 50022021300 
PRPH RDRA A 32 3014. 

PRPH PUNA A 33 3046 

PRPH IMPW A 41 ABSI 6 

PRPH IMPR A 10 ABSI 

MPC A 30 2 A 32 2 

MPC A 24 3 

MPC A 221A 23 14 

D355 A 21 A 


HSLA AQ 0 1200. 2 300. 2 4800. 8. 
HSLA A 0 20 1200-4 4&4 4800. & 


This setup deflnes a system with 7 MSUQ400 drives. 


Changes to DUMP ang PATCH . 


Tne device addresses typed to DUMP and PATCH when dumping 
specifled disk addresses tave been changed In a manner simlitar fo 
the config deck changese Requests to OUMP have the form 
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DEV <volume-designator> <device-positilon> <count> 
where <volume-designafor> may be one of 


<supsystem> <drive> 
PART <partname> 
ROOT 

BULK 


and <device-position> may be one of 


<Multics record number> 
RECORD <Multics record number> 
SECTOR <hardware disk sector number> 


Exampie: DEV DSK7 & 41941706 3-6 
and a device address request to PATCH has the form 


DEV <voltume-deslignator> <device-po0sitlon> <wordno> 
Example: SET DEV OSK7 5 10000 0 7676767676756 


Changes to SAVE and RESTOR 


The elimination of the PART MULT card changes SAVE and 
RESTOR drastically. The command tine now specifies onty the SAVE 
medium and options, like this’ 


SAVE <output-medlum> <options> 
Exampie: SAVE TAPE 1 2 ALL BRIEF 


Tne keywords ALL and BRIEF can also be glven, and Instead of 
TAPE 1 2 one could say OISK DSK? 3 4&4 or COPY DSK7 5. SAVE (or 
RESTOR) then reads request tines from the BOS Input source untill 
an END request is encountered. Each request speclfles one block 
of a physical volume to be dumped. Possible forms are: 


<voiume-designator> <extent> <opv_name> 
wnere <exfent> may be one of 


<device-position> FOR <count> 
<device-position> TO <irec> 
<device-posiftlon> ONLY 

ENTIRE 


Exampie?: DSK? 3 0 FOR 6 ROOT2 
DSK? 3 12 T0 17 LDDZ 
DSK7 1 9 ONLY 
DSK7 3 ENTIRE CHARLIE 
ROOT ENTIRE RPV 
PART LOG ENTIRE RPV 
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The PVNAME specifled at SAVE time will be checked at RESTOR time, 
so that physical volumes need not be remounted on the same device 
addressese Uniess ALL is specified, dumping an ENTIRE pack wilt 
dump onty those records in the volume which are actually used, 
pius the fiabel informatione the volume man; and the VTOC. 


For example, to save the volumes on unlts 1 and 2 onto disk 
packs on units 3 and 4 in the sampie configuration above, the 
operator mighf fype 


SAVE DISK OSK? 3 4 
OSK? 1 ENTIRE RPV 
DSK? 2 ENTIRE CISL? 
END 


(Assuming that the physical volume name of the pack on unit 1 is 
RPV and the name of the pack on unlit 2 is CISL2.) The Indented 
fines are request tines read by the SAVE command; each input 
request is acknowledged by a message of fhe form 


OSK7 1 (M409 A 30) DO. TO 19269. 


put tne SAVE does nof actuaily start until aii input has been 
typed and the END request givene When SAVE or RESTOR begin a new 
volume of the SAVE medium, they type out a message describing 
what volume address from the Muitics data is on the SAVE medium, 
in the form 


RPV (OSK7 1) 123492 ON TAPE 3 


As each votume of the SAVE medium (tape reel or disk pack) Is 
finisned, SAVE or RESTOR will type out the error count. 


SAVE ang RESTOR do some checking of the volume tabets of 
disk packs. If an attempt is made to RESTOR the contents of one 
volume onto a volume with a valid fabel but a different volume 
name, RESTOR will! print 


PHYSICAL VOLUME NAME DOES NOT MATCH REQUEST 
REQUEST IS FOR FOOBAR, GUT VOLUME NAME IS RPV 


and refuse to proceeds Similarly, If an attempt Is made to use a 
storage system volume as a SAVE packs, the message 


NOISKS OSK7 & IS MULTICS STORAGE SYSTEM VOLUME CISL3 


wilt be printed and no SAVE or RESTOR will be donee Instead of 
typing END the operator should type the QUIT request fo return to 
BOS command tevei; he should then check the assignment of packs 
to disk units very carefully. In very rare cases, a pack will 
have an incorrect fabel teft over from a previous use, which 
causes one of the above messages and prevents SAVE and RESTOR 
from operatinge The TEST command shovcld be used to clear the 
jabeil in this case. 
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Changes to TEST and EMT 


The TEST and FMT commands now operate on. only one pack or 
part of a pack at a times One may s2y 


TEST <subsystem> <drive> <extent> <options> 
Examples: TEST OSK7 3 ENTIRE WRITE PATERN 525252525252 


FMT <subsystem> <drive> <extent> 
Example: FMT OSK7 i 6 FOR 16 


‘and so forthe The keywords CHECK, WRITE, and PATERN still work 
for TEST. . 


Changes to BOOT 


The BOOT command now ailows the operator to say any single 
command to Mulitics ring-1 as an argument to the 60S command. fhe 
most common form wlll be to Say 


BOOT STAR 


to cause the system to start up without pausing In ring 1< The 
Interface between BOS and Multics limits the commands which can 
be typed to four-character itemse The fottiowing commands are 
valids 


STAR Startup 

MULT multics 

SALV salvage_dirs 
STAN standard 
RPVS (see below) 


The printer should be ready and paper synchronized when 
bootdoading the system, since the salvager may be Invoked 
automatically.» If no printer is avéiitable, a SALV CNSL card 
Should be usede 


COLD Card Changes 


The new format of the COLD card and WARM card for a 80S 
bootioad deck looks tike this’ 


<warm_or_cold> <model> <chn> <drive> 
Exampies’ COLD 400. 30 1 


When BOS is bootloaded, the loader will read the tabel of the 
disk pack at channel 30. unit number i, as if it were a MSUQ490 
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drivee The jabel of this pack will be checked for existence of a 
BOS partition, and the extents of that partition found In the 
labei wili be used. The BOS foader will type out a message of 
the fora 


BOS PARTITION AT 1914704 FOR 170+ 


giving the first record address and size of the partition. If no 
BOS partition can be founds one of the following messages wil! be 
printed: 


CANNOT READ VOLUME LABEL 
VOLUME DOES NOT HAVE A MULTICS LABEL 
BOS PARTITION NOT OEFINEOD IN VOLUME LABEL 


these messages usuaily result from an Incorrect COLD or WARM 
card, or leaving an incorrect pack mounted. 


BOS_Loager Changes 


For the first pootioad of BOS on an empty residence volume, 
a special method must be used, since the pack has no tIiabef. In 
this case, tne COLD card is replaced by the following card’ 


NLABEL <model> <chn> <drive> <device-positlon> <nrec> 
Exampie? NLABEL 400. 30 1 19100. 170. 


The 417G-record BOS partition occuples addresses 19100°19269 of 
the MSUG4QG0 pack on drive is channel 30 of the bootioad I0OM. The 
next step is to initialize the labei of the 80S residence votume, 
by means of a BOOT COLD. This rare situation Is the only time 
that an NLABEL card should be used, since it can destroy the 
contents of the storage system if packs hawe been moved. 
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OPERATOR COMMAND CHANGES 


Tne salvager is now bullt into the regular Multics system, 
ana if the system detects an inconsistency while bootloading, the 
Saivayer wiit be invoked autfofiaticaiiye The operator may aiso 
request the saivage of tne directory hnlerarchy or of any single 
volume by a command. 


The disk configuration -- that iss which disk drives contain 
which physical volumes -- Is not expressed on the CONFIG cards, 
and so must be conveyed to the system in another way. The system 
keeps a table of which volume is on which disk unit, called the 
disk_table, and on each bdbootioad gssumes that no volumes have 
been moved untltl told otherwise, In the normal case, the 
operator may start the system up without typing any commands 
which pertain to the disk configuration. For a cold boot, 
however, the operator must tell the system about the position of 
ail volumes with the “add_voi™ and “add_Iiv™ commands, which tell 
the system to accept the volume if its tabel matcnes the 
registered attributes for the volume. Once the system has been 
told where a volume is, it assumes that if wlll not be moved. 


Volume Registration 


Before a storage system volume can be used it must be 
registered. There is a registration file for each fioglical 
volumee The registration fiite contains the data necessary to 
mount the logical volume correctiy and to control its use. For 
exampie, the registration file of the logical volume “root” might 
look like this? 


ivnames roaot 


ivids 220931524466 
owner: InitiatizereSysDaemon 
public? yes 


min access_class? 07900000 

max access _ciass3 73777777 
acS_path3 >Ivorootfeacs 
novs 2 


pynames rpv 


pvid3 220531524345 
serial’ 2733-58 
model: 409 
locatlon? online 


pyname’ root2 


pvid: 5701440 45169 
serial’ 2733-59 
model: 406 


focation: ontine 
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This is a sampfe of the output of the “list. vol_registration™ 
commana described in appendix 8B.» 


Since the registration file contains the name and model 
number for each pnysical!l volume In the toglcal volume, the system 
can teil whether a logical votume is completeiy mounted, or if 
there are enough free drives avallabie to mount all Its physical 
yvolumese 


ACCESS CONTROL 


In each volume registration fliie, several pieces of 
information about access control are kept. 


Public and Private Volumes 


A volume may be either PUBLIC or PRIVATE. Public volumes — 
are like pre-4.9 disk storage: segments on public volumes can be 
referenced by user programs subject to the normafi ACL and ring 
checkinge To access a segment ona private voiume, the user must 
still tave appropriate permission to the segment; but in 
addition, the user must have completed a “mount™ operation for 
the private togicai volume. . 


Access Controi Segment 


In order to mount a private volume, the user must have 
appropriate access to a special segment caifed the Access Control 
Segment (ACS) for the logical volumee The SOLAN EON of the ACS Is 
specified in the volume registration file. 


Access Isolation 


For sites which use the Access Isolation Mechanism, each 
fogical volume may have a range of sensitivity tevels specified. 
Segments outside the given range cannot exist on any physical 
volume of the ftogical voiume. 


Master Directory Control 


A user may create a master directory for a fcgical volume 
oniy if ne nas a Quota Account for the volume, registered in the 
volume*s Master Directory Control Segment (MOCS). The MOCS JIists 
all quota accounts for its iogical volume, tne master directories 
charged to them, and their quotas. 
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Volume Executive 


Certaln users may moolfy the MOCS for as. logical volume. 
Tnese users are caliea Volume Executives for the togical volume. 


=o ane Po 


Votume executives nave “e”“ access fo the ACS for The voiume. 


DATA BASES 


The volume registration file and the MDCS are ring-t 
segments stored in the directory >lIv. Tne ACS for private 
volumes is stored in a directory namec by the volume owner. For 
public volumes, the ACS Is kept In >tve 


Because the system must be abie to access the registration 
flle of the root togical volume before it can. accept the other 
physical volumes of tne roofs a special arrangement has been 
madee The registration data for the root togical volume Is 
actualiy kept in segments in the root directory itself. Links 
are placed in >iv which point to the segments in the root 
directory. 


If the system cannot ftocate a registration file for tne root 
fogical volume at startup time it recreates one, since the system 
requlres thls segment in order to operate. 


REGISTERING VOLUMES 


A new operator command, “add _vol_registration™ (avr) is used 
to register ail volumes except the RPV. The add_vol_registration 
command can be executed in ring 1 or ering & A Sampte call to It 
might took tike this 


avr pv pubdjs& -tv public 


In thls exampie tne physical volume named “pubg4a™ Is being 
registered as a member of the logical volume named “public.” 


Each physical volume must be registered before it Is 
initiailzede When the physical volume is iInitiatized, 
registration information from the votume registration data Is 
copled Into the physical votume label. Whenever the physical 
volume is mounteds the pnysical volume tabel is checked against 
the registration datas 


Many control arguments may be specifled to the 
add_voi_registfration command. A compfete description of the 
command Is provided in apnrendix Be 


Tne “change_vol_registration“", “del_vol_registration”, and 
“tist _vol_registration™ ("“cevr"“, “dvyr™, and “tvr™) commands are 
also provided to change, delete, and list the volume registration 
datae These commands are aliso descrlbed in appendix Bs 
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A special command is provided for regenerating the 
registration data for a physical volume if the registratlon data 
was destroyed In a crashe the command 


reregister <pv_name> <drive> 
Example: reregister george dskb_04 


will cause the system to read the label of the physical volume on 
the specified drives and if iIfs volume name is corrects to 
regenerate any missing parts of the registration data. This 
operation is performed autfomaticaliy as part of startup for ali 
volumes which are part of the RLV. 


VOLUME INITIALIZATION 


The “init vol" command takes a bdiank disk pack and 
initializes It to be a Multics storage system physical volume by 
writing a tabel, an empty volume maps and an empty VTOC on the 
pack. Each volume aust be initiatized before it can be used by 
the storage system. 


Only registered volumes can be initialized. 


The inilt_vol command reads the !ltabel of the ohysical volume 
it is supposed to register before writing on ite If the fabel is 
a valid-appearing Multics label, for any other volume, init _vol 
wiil print an error message and refuse to proceed. This check is 
a safety feature fo prevent the accidental destruction of the 
contents of a valid physical volumee In rare cases a pack may 
have a vailid-appearing label from some previous appiication which 
prevents it from being relabelede In such a case the pack should 
be erased first before init _vol is Invoked. . 


Mounting Volumes 


When the system is bootloaded, the hardcore system runs In 
tne hnardcore partition defined on the RPV by the PART HC card in 
the configuration decke Ouring file system Iinitiatizatlon, the 
root directory is tocated and that section of the directory 
hierarchy which resides on the RPV is made available for the 
Systeme The root togical votume is defined at this time. Other 
PART cards may point to other disk units$ if sos the partitions 
-will be focated by tooking at the tabels on the packs on these 
units but segments on these volumes are not made avallable for 
Multics use during hardcore initiatiizatione 


This is the situation when the system comes up in ring te 
Onfy the root logical volume is defined, and the only physical 
volume being used is the RPV. This is the only time that the 
System operates with a partlaily mounted logical volume. 
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The operator®’s normal action is to issue a series of add_vo! 
commanas to cause the other volumes of the root toglcal volume to 
be mounted, and then to issue add_iv commands and addovol 
commands for additlonal icgica!l voluwes and the physical volumes 
that make them upe 


The operator may tist the disk table to find out which disk 
drives are mounted by issuing the “tist -dlsks™ ("td") command. 
Its output looks Iike this? 


dska_014 root2 root 

dska_02 new (biue) * 
dska_03 fio drive) 

dadska_04 

dska_05 (deleted) 

dska_06 true (blue) ee 
dska_07 

dska_08 

dska_09 

dska_i0 

dska_iil 

aska_i2 rpv root 

dska_13 

dskb_0i1 

dskb_02 

dskb_03 

dskb_04 

dskb_05 


In the example, the operator has Issued the command 
add_vo! rooted dska_01 


to complete the root volume. The one star after the tine’ for 
dska_0G2 indicates that the pack on dska_02 is assumed to be the 
physical volume “new™ of the fogical volume “blues” Since It Is 
assumea, the system has not yet read its fabel. The three stars 
after the tine for dska_06 incicatfe that the pack on dska_06 is 
Known to be the pnysica!l volume “true” of logical volume “blue” 
-- the system has read the label of dska_06 and it matches the 
registration for physical volume “truee™ The add_vol command 
makes a volume known, but does not make it avallabte for paging 
uniess an addilv is pending and this add_vol completes fhe 
logical volume. The parentheses around the fogical volume name 
Indicate that the togicai votume “biuve™ is unavailabte for 
paging. 


To cause all assumed and known physical volumes of a logical 
volume to be accepted for paging, the operator issues the add_iv 
commande If this command is issued when some physIcal volumes of 
the tlogical volume are not tisted In the disk table, the system 
will type out mount messaces for each physical volume and will 
then assume that the ophysicat volumes wlltt be mounted on the 
specified volumeSe Tne operator wili then type add_vol commands 
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for each physical volume which has been requestede When the last 
add_voi command is typed, the system will respond with a message 
saying that the ftoglcal volume is mounted. 


In the exampite above, if the logical volume “biue* were 
registered fo contain cniy tne two physicai voiumes “newn* and 
“true,” the operator could issue the command 


add_tv biue 


to cause fhe fabel of aska_02 to be read and checked, and “to 
Cause both physical volumes to be accepted for paging and the 
jogical volume to be made available for user use. The system 
would fype fhe message 


public iv blue mounted 
and the output of iist disks would then look tike this? 


dska_Oi root2 root 
aska_C2 nen biue 
dska_03 (io drive) 
dska_04% 

dska_05 (deleted) 
dska_06 true blue 
aska_o7 

dska_08 

dska_09 

dska_i0 

dska_ii 

dska_i2 rpv root 
dska_1i3 

dskb_01 

dskpb_02 

askb_03 

dskb_04 

dskb_05 


physical voiumes which are being used have no stars after their 
namee 


If the system has been brought up after packs have been 
moved, the disk table may show certain assumptions which are no 
fonger truee The dei_vol (dv) commanc can be used fo erase the 
entries for assumed or known physical volumes from the disk 
table. The del_vol command does not do anything to any disk 
drive; it Jusf changes the fable. 
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Default Startup Operations 


At this point if may appear that the operator has to type an 
add_vol command for each physical vo!tume and a add_tv command for 
each toglcal volume, in order to get the system started. Not so? 
default assumptions have been built into the system to eliminate 
extra commands when they are not necessarye 


Whenever the Initiallzer process crosses from ring 1 toring 
Gy aS a result of the “startup”, “mul tics", or “standard” 
commands, the system does an automatic “add_iv root™ to insure 
that the root logical volume is complete. If the root cannot be 
completed, the system remains in ring 1+ since ofherwise It might 
attempt to access a directory whlch was not mounted. 


Wnenever the Initiatizer oerocess attemots to start the 
answering services, as a result of the “startup” or “nultics” 
commands, or when a “reload” command is issued, an automatic 
“"add_liv -al!" command Is executed to attempt to mount all togical 
volumes which are not in use because one or more of thelr 
physical volumes is known or assumed. If any togical volume 
cannot be completed, the answering service startup Is not 
attempted. The operator may then use the del_vol coamand to 
correct the disk tabfe and fry startup again, or may use add_vol 
to obtain the missing volumes. 


Tnese default assumptions mean that If the operator just 
types “startup” in ring i» as he is used to doing, all volumes 
which were in use at the time of shutdown wll! be re-accepted and 
the system will resume operation. If the operator issues the 
command “BOOT STAR™ fo BOS» and If all physical volumes are where 
they were at the time of the fast crash or shutdown, the system 
wilt not even pause in ring ie But if there is any trouble, the 
system willl walt for an operator command Instead of ptunging 
ahead obdlindiy. As described below, the salvaser has been 
integrated into this scheme so that if satvaging is necessary it 
Is Invoked automatically. 


These changes are part of a general plan which wlll allow 


the system to be left in unattended mode, with a 80S runcom which 
will reboot fhe system if it crashese 


Qemounting Volumes 
A physical voftume may be in one of the following states? 
14- Not mounted 
2. On the drive but drive not ready. 


3* Orive readys system unaware of contents. 
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&e Known (system has read tabel). 
5. In use for storage system or [/0. 


The add_voi and add_iv commands can move a physical volume to 
nigner-numbered sfafese There are also commands’ for moving 
physicai volumes back down. 


The command 


del_iv <iv_name> 
Examples def_tv blue 


causes the system to make al! segments on the. tlogical votume 
<iviname> unavailable to users, and then causes the orderly 
snutdown and unloading of each physical volume contained in the 
fogical volume. As each disk unit is unloaded a message of the 
form 


demounted dska_j2 


will pe printed. Since segments which users may be using are 
made unavallabie by the defi_iv commands the operator should use 
this command only when he is instructed to do soe 


Since the system wiil encounter errors if a disk drive is is 
Stopped manually when it shouldn*t nave been stopped, the 
software is designed to support the following ruie’ 


Never stop a disk drive manuatty white 
Muitics is in operation. | 


When the system demounts a disk pack, either a storage system 
physical volume or an I/0 pack, it wll! always unioad the disk 
drive by program controi.e 


Changes _to 01d Onoerator Commands 


adddev, addd Now allowed in ring 1 as well as ring 4&4e 


This command may specify a storage system 
disk drive which has been deleted by the 


deldev command. 


deldev, deid — Now allowed in ring 1 as well as ring 4. 
. This command may specify a storage system 
disk drivee If the drive Is currentiy In use 
for paging, an error occurse Otherwise, the 
drive is made unavallabie for storage system 
UuSee 


force_reset Name changed from “force”. 
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storage, stor Abbreviation changed from “dym™. Output 
format changede 

multicsS, mult Now mounts volumes If necessary. 

standard, stan Now mounts volumes if necessarye 


startup, star Now mounts volumes If necessary. 
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NEW SALVACER 


Tne storage system structure repair procedures known 
collectively as the saivager have been extensively modified In MR 
4eQs both for automating crash recovery and for handling the 
structurai changes in fre sforage system datae The saivager 
programs are now part of the standard sysfem tape; new salvaging 


modes have been introduced and some oid modes redefined; and 
control of the saivager is now from command options rather than 
from the processor switchese There are now four kinds of 


salvaging operation which the system can perform. These are 
emergency shutdown, volume saivage, directory hierarchy salvage, 
and on-line salvagee The system has been modified to invoke the 
Salvager automatically whenever data In the etense nierarchy may 
have been damagede 


Emergency Shutdown 


Emergency shutdown has been reworked completely and greatly 
lmprovede It is much more reliable than in pre-4.0 systems. 


Sometimes the system crashes before the sforage sysfem has 
been turned on. Previously, an attempt to emergency shutdown’ in 
such a situation would tftead to another crashs and might do 
serious damage to the directory hierarchy. This has been changed 
so that if a premature emergency stfutdown is attempted, the 
foliowing message is printed: 


ESD BEFORE FS ENABLED 
SHUTDOWN COMPLETE 


and the directory hnlerarchy is untouched. 


It is atways safe to attempt an ESDs and If emergency 
shutdown crashes if may be retried. 


Voiuge Salvaging 


Volume salvaging insures fthat there are no reused addresses 
or ifti-formed VIOC entries in the VTOC and volume map of a single 
physical volume. 


If a volume was In use by Multics and was not demounted or 
shut down by normal or emergency shufdown, it wiil be salvaged 
automaticaily the next time that the physical volume Is accepted 
for paginge 


The operator may force the volume salvage of a particular 
volume by typing the command 


salvage_vol <vol_name> <drive> <opfilons> 
Examples’ saivage_vol new dska_Q2 -check_dir 
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This operation cannot de done once the volume has been accepted 
for paging. Options may come from controt arguments or from the 
SALV carde The “-check_dir™ option causes the connection between 
tne VTOC entry and the segment’s directory entry to be checked 5 
lf there is no directory entry for the VTOC entry, tne VTOC entry 
wlili be deleted. 


To cause the volume saivage of all onysicatl volumes which 
are assumed present or known but not yet in use, issue the 
command 


Salvage_vol -ali <options> 


A special interface is avallable to force the volume salvage 
of the Root Physicai Volumee Typing 


BOOT RPVS 


wil’i force the RPV to be saivaged during boottoad. (Part of the 
directory hierarchy on the RPV alli aiso be salvaged, as 
described below.) The RPVS option may be combined with any other 
command, so that 


BOOT RPVS SALV 


is a vaiid command, which caijs for a volume salvage of the RPV, 
a salvage of the directory hierarchy existing on the RPV, and 
then a directory hierarchy saivage of alti directories. 


The “\-check_dir™ option for tne satvage_vol command cannot 
be used on volumes which are part of the RLV. Volume salvaging 
can onty be done on un-accepted volumes; but in order to do fhe 
-check_dlr operations the the RLV must be completely accepted so 
that all directories can be tooked at. If the dlrectory salvager 
destroyed a branch for a segment on the RLV, the “orphan” VTOC 
entry would never get cleaned up if Multics were unable to 
connection salvage. A speciai scheme is provided to do a 
saivage_vo! of a gagy of any physical volume of the RLV. Using 
BOS, the operator coples the physical volume or physical volumes 
to be checked onto scratch packs. After bootioading tne system, 
the operator then tyoes 


salvage_vo! <pv_name> <drive> -copy <drive2> 
Examples salvage_vol root2 dska_04 -copy dskb_05 


changes, if anys are made to the copy, not to the version of fhe 
RLV pack that the system is running one After all satvage 
operations have been done, the system can be shut down and the 
Salvaged coples used to repface the old versions. 
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Hierarchy Salvaging 


Hierarchy salvaging is the most tike the pre-4&.§ salvager: 
it corrects ali errors in directories, rebuliding the directories 
if necessary. The directory nierarcnhy saivager is invoked by 
operator command by typing 


saivage_dirs <options> 
Example’ salvage_dirs <-check_vtoce 


The “-check_vtoce”™ option specifies that connection from the 
directory entry to the VTOC is to be checked; if a directory 
entry thas no VTOC entry it wilif be deleted. The “-rebuild™ 
option specifies that ail directories should be rebulit. Both of 
These options increase running time sudstantilaliy. 


RPV SALVAGING 


Whenever a volume saivage is done on fhe RPV. the directory 
hierarchy saivager is invoked to salvage the root directory and 
every directory at up to two fieveis below fhe root if alt the 
directory*®s parents are on the RPV. This operation Is done in 
order to make sure that the system can complete bootioad and come 
up to ring 1 command tevel. . 


RLV SALVAGING 


Before ieaving ring 1,5 the system automatically salvages 
directories down to level three of the dlrectory hierarchy If any 
volume of the root togical volume was automaticaiiy volume 
Salvaged. This action, cailed RLV salvaging, is taken because 
such a volume salvage may have detected a reused address and 
Introduced a page of zeroes into a crucial directory. 


Qn _ Line Salvagec 


The on-line saivager is invoked by recovery mechanisms when 
certalIn software errors or hardware fallures occure It can also 
be invoked manually by a system programmer who calis 


hphces_$salvage_directory (path). 


Tne MR 4&8 version of the on-line saivager has been substentlally 
improved over previous versions. 
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Paging Device Fiush 


The paging device, if present in a configuration, will be 
flushed in stages as each volume IS acceptede Except In cases of 
r 


After a crashe try ESD. 

If emergency shutdown does not complete, make 
sure ftnat alt volumes in use at the time of 
the crash are accepted during saivage. 


Observing this rule insures that ali informatlon on the paging 
device will be flushed back onto the voiume where it belongs. 


The system wlll not exlt from ring 1 untill the paging device 
has been completely fiusned. 


MULTICS OPERATING STAFF NOTE MOSN-A001 page 25 
NEW ERROR MESSAGES 


Multics Disk Error Messages 


Tnese messages have been changed fo show the subsystem and 
drive number. The generai error will look tike this? 


disk control: dev attention for dsk?7 4 {Lomi chn 30) cmd 4&2 
stat 422000000000. 

disk_control: dsk7 4 sect=765, cyl=14, hd=0, addr=13370. 

disk controls dsk7 4 detailed status? 49 00 60 80 60 00 


Tne detailed status messasce wiil only be printed in cases where 
it Is useful. If the disk unlt Is unusable, for exampie if If 
has gone into standby sfafe, the message 


disk _control: dsk7 & requires intervention. 


wiiftt be printed and the aiarm wili sound. The operator may ready 
The drive, after correcting the probiem; the system will then 


Type 
disk control: dsk? 4& now operative. 
and attempt to use the disk unit again. 


The other possibdje error messages about dlsk wll! not, in 
generai, require operator interventions 


disk control: I0M system fault for dsk7 4. 

disk control? Ignored special on dsk7 4e 

disk_controi: Interrupt from unknown devx 7» SX 7e 
Status = 422008000000. . 

disk _controi: Lost I0M interrupt for dsk7 4& (iom 1 cnn 30). 

disk_control: Unexpected I0M status 4220000000007770000000G0 
for dsk7 4 (lom 1 chn 39). 

disk _controi: dsk?7 4& talty residue = 0001. 


BOS_Disk Erroc_ Message 


The error message printed by BOS for a disk error is simliar 
to the Mulfics messagee It fooks jiike this3 


ERROR ON M400 A 30 4& {0SK7) 
CMD=32,5 S=3445, ADOR=666000, STAT= 422000 777000 
DETAILED STATUS: 22F0000000004000 


The subsystem name (0SK7 in the example) may be replaced by stars 
if BOS has not yet read tne CONFIG deck. 
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Bootioad Error Messages 


If the operator attempts to boot the system with the clock 
set to an obviously baa vatue, the system will crasr with one “of 
TnNese MESsagesié 

init pvt? clock malfunctioning 
Init_pvt: incorrect clock setting 


init pvt: clock reads time before rpv ftabel 


this crash occurs before any changes are made to the dlsk 
contentSe 


An attempt to boot the system witn a non-root volume where 
the RPV should be willl usuaily result in a crash with one of the 
messages 


init pvt: no root 
init_pvt: dska 3 nas no Muitics label 
init_pvt no part ne on root dska 3 


the ROOT card must be corrected, or the contents of the RPV 
restorede Once again»s no changes nave been made to the disk 
contents. 
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CHANGES TO OPERATIONAL PROCEOURES 


Severai of tne standard operatioral procedures are affected 
by the nen storage system. : 


atandacd SAVve 


The system programmers will rave set up some new RUNCOM 
files for the standard SAVE procedures. At teast the foilowing 
allio be provided’ 


SAVET Save all volumes to fape 
RESTT Restore ali volumes from tape 


When a new volume is added to the system, or any voiume is moved 
from one disk unit to another, these RUNCOM files must be 
updatede 


atangarcd Dumps 


The reguiar incrementai, catchup, and complete dumpling 
procedures wilf not change too much with MR 420, buf fhe 
installation management may choose fo rearrange the dump control 
files. 


Changing Disk Configuration 


If the PRPH DSKx card is changed, the system is unable to 
assume anything about the tocation of any volumes on the next 
bootloage So after a change to the PRPH OSKx cards the operator 
wiilf have to type an “add voi” command for every volume in the 
Systeme 


In order to add a new volume to an existing logicai votume, 
The operator must shut down and reboot, and type an 
“initialize _agisk™ command for the new volume when ring 1 command 
level is reachede 


Crash Recovery 


Many internal changes have beer made to Muitics so fhat it 
will crash less often and make crashes which do occur easier to 
recover frome 
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PAGING DEVICE RECOVERY | 


After asystem crash, the standard procedure Is to attempt 
an ESD firste If ESO fails or cannot Fra attempted because core 
has been !osf, do a 


BOOT SALV 


to cause the saivager to be rune If the ESO was not done, the 
following message will be printed when the salvager ls 
bootioaded? 


init pvt: paging device will be flusheds 2040 records 


If this message occurs, The paging device records for each volume 
witt be flushed onto the volume as it is accepted for paglnge 
(This operation takes a few extra seconds for each volume.) At 
tne end of salvaging, if the operator types “startup”, 
“standard”, or “multics™, the system wlll attempt to enable the 
paging device, and If successful will orint the message 


enabled pdi 2040 records 


giving the size of the paglng device. If some volumes, which 
were mounted at the time of the crash, don*t get accepted during 
the next bdbootioad (salvager or reguiari, the paging device may 
contain pages which must be flushed before the paging device can 
be used for regufar paging. Tne system will refuse to enter 
normal operation if this is So» and will print 


errort paging device unflusnhed. need 2 vols for 78 recs 
Command? 


The system will not enter standard mode (ring 4) untll the paging 
device is completely fiushed.e In some cases, for example If a 
pack has a head crash, it may be imcossible to flush the paglng 
device completely; in other cases, for instance if a disk MPC 
goes down, several boottoads with different volumes on-tine will 
be required to get all PD recoras flushed. Once ali flushabte 
recoras have been flushed, the operator must Issue the command 


force_pd_abandon 


to clear the paging device of records which cannot be fiushed. 


DISK UNIT FAILURE 


Often, onty one disk pack or disk unlt Is Invotved in a 
system faiture.e. The symptom that an operator wii! notice is a 
burst of write error messages for the drive, and then a message 
tike 
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disk_control: dsk7 4 requires intervention. 


with an audibie alarm. The error messages may repeat 
periodicaliye In some cases, the system crashes when a disk unlt 
falis; but often the system will continue operating saithough 
wifhout The avaiiabiiity of segments on the device affected. If 
a disk drive has dropped Into standdys and the system Is stlil 
operating, the operator should attempt to ready it. If the drive 
can be made ready, the system will print 


disk_control: dsk7? & now operative. 


and attempt to use segments on the drive again. If there has 
been a head crash or fhe disk unit has become unusable, the 
operator must shut down, substitute a spare or repaired disk pack 
and drives and use RESTOR to restor the contents of the volume 
from the iast SAVE by typing 


RESTOR input_mediua 
DSK7 4& ENTIRE USER _PACK_8 
END 


and mounting the appropriate tapes or SAVE packse The next sfep 
ls to reboot the system, and reload the segments which have 
changes since the SAVE by issuing the followlng command: 


reload -pyname user_pack_8 > 


and atlowing reioad to scan ali catchup and incremental tapes 
made since the SAVE.}j If the site has a paging device, and there 
are pages for the damaged volume on the paging device, if would 
not be safe to flush these pages back onto the nen packs even 
after reloading so the system staff will probably have fo zero 
The paging device as described abovee 


If several volumes are damaged» and some are from fhe RLV, 
these volumes should be reticaded before non-RLV volumes are 
attempted. 


Checking Number of Records Left 


The system nandies out-of-aisk much betters; running out of 
disk on most volumes is no longer a system crash, afthough it may 
annoy users with segments on the volume. 


The device_meters command no fonger tells how many records 
are feff. To get a summary of what volumes are on-line and how 
much room is feft on thems, type 

fist vols 


while in admin modee The output Is sorted by logical volume 
Nnamee If the argument “-iv NAME” or “-pv NAME” is givens oniy 


MULTICS OPERATING STAFF NOTE MOSN-A001 


that physica! or togical volume will be 


fike this: 
Orive Records 
dska_02 P 47752 


dska_04 P 17752 
dska_03 18322 


Left 


3688 
3333 
4102 


VTOCs Left 
2817 1850 
2817 1865 
41435 2438 


listede 


PV name 


rov 
cisle2 
idd 


page 30 


The output looks 


LV name 


root 
root 
florartles 


The “P“ fiag above indicates those drives containing partitions. 


If the “-totai™ argument 


Records Left 


18322 4102 
35504 7021 


VTOCs 


4135 
5634 


Left LV Name 


is given, the output is 


2438 tibrarles 


3715 root 


and the operator “storage™ command now does a “Iist_vols -tt. 
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APPENDIX A 
LIST OF OPERATOR COMMANDS 
The foiiowing tist shows aif! ring-i1 and ring-4 commandse 
Uniess otherwise noted in the “Ring™ column, the command is for 


ring-4 only. . 
Command ~ Abbrey Rina 


abs abs 

accept acce 

add_fv alv NEW both 
add_voi av NEW both 
add_voi_registration avr NEW both 
addcpu — addc 

adddev addd CHG both 
addmem addm 

addpage addp 

admin 

attach _ atta . : 
bos both 
bump 
change_vol_registfration cvr NEW both 
cripple a crip | 
define defi 

del_iv div NEW both 
del_vol dv NEW both 
dei_vol_registration dvr NEW both 
deicpu deic 
deidev — deid CHG both . 
deimem dein | 
deflpage deip 

deroutfe dero 

detach deta 

develop . deve 

doan 

drop 

exec x 

force_resef CHG 
force _pd_adandon NEW ring-1 
go 

help ring-1 
hmu 

init_vol NEW both 
intercom Ic 

list udisks id NEW both 
jist _vol_registration {ve NEW both 
togin logl 

logout {ogo 

maxunits maxu 

mc_tist 


mc_on mc 
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message mess 

multics mult CHG both 
no start ns 

quif 

rcp 

redefine rede 

reload both 
reload_system_release ring-i 
remove remo 

reply r 

reregister , NEW ring-1 
reroute rero. 

reset rese 

route rout 

salvage_dirs salv NEW ring-i 
salvage_vol Sv NEW both 
Shutdown shut both 
standard stan CHG ring-1 
startup star CHG both 
stop 

storage stor CHG 
substty subs 

sysid sysi 

terminate term 

unbump unbu 

undefine unde 

warn w 

who 


word 
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APPENDIX B 


COMMAND DOCUMENTATION 


Only new commands are written up in this section. 
Multics Operator’s Handbook for other commands. 


page 33 


Consult the 
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Name! add_vol_registration, avr 


Fuoction®’ Register anew physical volume. If fhe logical volume 
does not already exist, register the new logical volume aiso. 


Syntax? add_vol_registratlon pv pv_name controt_args 


Acguments? 
pv is the titerat string “pv" 


pv_name . is tne physical volume name 


Gontrol Acauments! 


“Iv LVNAME specifies the ticgical volume namee This 
argument musf be erovided. 


-model MOONO specifles the Honeywell model number for the 
disk packe If omitted, the default is 400. 
The following are valid vaiues for MODNO? 


484 0SUi81 
191 O0S$i91 
400 MSU0400 
450 MSU0450 
-seriai SER Specifies tne manufacturer*s seria! number 


for the pack. If this argument Is omltted, 
the defauit is “none.” 


The remaining arguments are valid only when a new Jogical volume 
ls being registered. Otherwise they are ignored. 


-owner PersoneProject Specifies the user identifier of the 
volume ownere If omitted the Persons.Project 
of the user executing the command is used. 


“access_!ow xxx . Specifies the minimum sensitivity tlevet for 
information on the volume. 


eaccess_ high xxx Specifies the maximum sensitivity level for 
information on the volume. 


“public YESNO Specifles whether the volume is public. If 
omitted the default is “yes.™ 


“acs PATH Specifies the path name for the ACS. 
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Name? change_vol_registrations cvr 
Eunction: Modify logical volume or physical volume registration. 


Syntax: change_vol_registration pv pvname controlt_args 
change_vol_registration iv iv_name control_args 


Acguments? ; 
pv is the titera! string “"pv™ 
pyname is a physical volume name 
iv is the literai string "tv". 
iviname is a fogical volume name 


Controi Arguments: Tne following controt arguments are valid 
when “pv™ is specifiad? . 


-mode!l MODNO Specifies the Honeywell modei number for the 
disk pack. The following are vatid vaiues 
for MODNO? 

181 ~DSU1L81L 
1914 0SS194 
400 MSU04&00 
450 MSU0450 
-serial SER Specifies the manufacturer*s serial number 


for the disk pack. 


-iocation LOC Specifies tne current location of the disk 
packe 


-date_registered DATE Specifies the date the physical volume was 


registered. 
“name PVNAME Specifies the physica! volume name. 
-pvid PVIO | Specifies the unique identifier of the 


physical volume. 


Tne following arguments are valid when "fv" is specified 


“owner PersoneProject Specifies the user Identifier of the 
volume ownere 


-access_JOonw xxx Specifies the minimum sensltivity ftevel for 
information on the volume. 


“access high xxx Specifies the maximum sensitivity level for 
inforrwation on the volume. 


-pubiic YESNO Specifies whether the voiume is public. 
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“acs PATH Specifies the path name for the ACS. 

“name LYVNAME specifies the iogical volume name. 

=itvid wvid Specifies the unique identitier of the 
volume. 


Notes: Changing tne name or unique ID attributes of a physical 
volume or togical volume is an operation which Is oniy done to 
correct a wrong registratlon fite. The volume ftabel Is not 
affected by the change to the registration files, and simely 
changing the registration file wiil usually have only the effect 
of making the volume or logical volume unmountable 
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Name: del_vol_registration, dvr 
Eunction? Unregister logical voiume or physical volume. 


Syntax? del_vol_registration pv pvname 
del_vol_registration iv iv _rame 


Arguments! 
pv is the literai string “pv™ 
pvname Is a physical volume name | 
iv is the Iiterali string "Iv" 
iv_name ls a logical volume name 
Notes? 


When “pv” is specifieds the command wlil refuse to ieave 
fogicail volume with no physical volumes In if. 
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When unregistering a fogica!l voiume, the physical volumes being 


releaseo wili be tistea. 
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Name? 


Eunction: 
physical 


ayYnotax? 


fistuvol_registration, ivr 


Print registration information for 


volumes 


fist_vot_reglstrarion pv pvnrame 
jist _vol_registration iv !voname control_arg 


Acguments: 


pv 
pvname 
iv 
Iv_name 


Conitcol 


argument 


Exampie? 


is 
is 
is 


Is 


Arguments: 


If 
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logical volume or 


the ilteral string “pv™ 


a physicat volume name 


the literal string “*tv™ 


a iogical 


“ty” 


volume name 


is specified, 


fists onty ohysical volume names. 


fist_vol_registration lv root 


Ivname’ ro 
ivids 
owner’ 
public’ 


of 


min_access_ class: 
max _access_ciass? 


acS_path’ 
npvs 


pvname3 
pvid: 
serials 
model’ 
Jocation’ 


pyvnames 
pvid3 
seriai? 
model 
location: 


rpv 


root2 


list_vol_registration 


rpv 
root2 


lv root 


220531524466 


the “-brief™ (“-<bf™) 


Initializer.SysDaemon 


yes 
0:000009 
78777777 
>ivoroote acs 


2 


2205315 24345 
2733-58 

490 

oniine 


5791449045160 
2733-59 

490 

oniine 


-bf 
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Name: add_vol,y av 


Function: Teli the system that a physical volume is on a disk 
drivee Read and check the label. 


Syntax? add vol pvname drive_nane 
. add_vol -ali 


Arguments! 
pyname ls the name of a physical volume 
drive _name has the form <subsys>_<nn> 
Control Acauments? = 
“-all Mount all assumed physical voluses 


Notes? The registration flie for <pvname> is consulted to find 
out the togicai volume name and to validate the label. 


The volume label is read and checked.e. If the label is correct 
the drive is left in the kncwn state. 


If an addiiv commana for the _ fogical volume containing this 
physical volume nas oeen previously issueds and if this add_vol 
commana completes the togicalt volume, the togical vodiume is 
accepted for paging and a message is printed. . 
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Name: add_iv» aiv 


Eunstion: Cause a togical volume to be accepted for paging. 


Syotaxi add_iv iv name 
add_liv -ail 
Acguments? : 
jv_name is the name of a registered logical volume 
Control Acguments! 
-all Mount all Incomplete ftogical volumes. 


Notes! If atf~. physical volumes for the tftogical volume are 
already accepted, Known, or assumed, add_Ilv wili insure that aii 
iabels nave been read and checked, and wilt then accept the 
fogical volume for paging. 


If one or more volumes are missing, add_iv will assign drives for 
the missing volumes, print mount messages for each missing volume 
In the form 


mount pv K202 on aska_07 
and set the assigned drives into the assumed state. The operator 
may mount the ohysica!l volumes where requested or use nhils own 
Judgement. As each physical volume Is mounted, fhe operator wlii 
Issue an add vol command to the system; the last add_vol command 
will cause the ftogical volume to be accepted with a message of 
The form 

private iv co22 mounted 


When the add_iv command is issued, all assumed drives should have 
the correct contents; otherwise an error message wli! be typed. 


Tne iistvldaisks command tists afl outstanding add_iv‘s. 


Tne dei_iv command can cancel an outstanding add_iv. 
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Name: dei_vol, dv 


Eunction: Tell the system that a physical votume is no ftonger on 
a drive. 


ayntax’ det_vol drive_name 


Acguments? 


drive_name has the form <subsys>_<nn> 


Notes? The drive specified may not be In use. | See the del_tiv 
command for demounting logical volumes which are in use. 
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Name’ del_tivs div 


Function: Teii the system to force the demounting of a logical 
volume. 


ayotax: del_iv. ivname 


Acauments: 
ivname speclfles tne name of a iogical volume 


Netes: If the logical voiume is in the process of being mounted, 
thls command cancels the request. 


If the togical volume is already mounted, this command makes the 
segments on the volume unavailabie to all users, and shuts down 
and unloads all physical volumes in the flogicai voiume with a 
message of the form 


demounted dska_j2 


MULTICS OPERATING STAFF NOTE MOSN-ADO1 page 43 


Name? init _vol 

Eunction: Write the iabei of a new physical volume. Set up its 
VTOC and volume mape This operation destroys any oprevious 
contents of the physical volume. . 


Syntax! init vot pvname drive_name control_arg 


Arcguments: | 
pyname Is the name of a physical votume 
drive _name nas the form <subsys>_<nn> 


Control Arguments? 


“special Enter dlalogue with the operator. 


abecial Mode: 
In special mode the operator may specify the position and size 
of partitions on the physical volume. 


Tne following Reais! lines may be typed 

part NAME HILOW SIZE Where NAME is a 4&-character partition name, 
HILOW is either “high™ or “fow™", and SIZE Is the 
partition size in records. 

avg FFF.FF Specifies tne average segment length for segments = on 
the physical volume. The default length Is 5-0. This 
number is used to calculate the number of VTOC entries 
on the volume. 

fist fists the partitions defined so far. 


end causes the physical volume to be initialized. This 
operation takes about 99 secondse s 


quit causes an exit without doing anythinge 
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Name! 


Function’ 


list disks, id 


List 


pending add_tv“Se 


ayotax! 


Acguments! 


page 4& 


the usage of storage system disk drives and al! 


iist_disks arg 


Grive_name 


is the name of a drive to be tisted 


Control Acguments? 


“iv LVNAME 
“ov PVNAME 
-of 
-mt 


-briefs 
“mount >» 


Example; 


fist disks 


dska_O014 
dska_02 
dska_03 
dska_04 
dska_05 
dska_06 
dska_i7 
dska_08 
dska_09 
dska_10 
dska_ii 
dska_i2 
dska_13 
dskb_01 
dskb_02 
dskb_03 
dskb_04% 
dskb_05 


pubile Iv blue mount in progress 


jist only drives pertaining to LVNAME 
fist only drives pertaining to PVNAME 
jist cniy nonempty drives 

fist only pending add_Iv*s 


roort2 root 
new (btue) 
{io arive) 
(deleted) 

true (olue) 
rpv root 


HER 
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Name: reregister 
Function: Regenerate volume registration information. 


Syntax: reregister pvname drive_name 


Acauments! 
pvname . is tne name of a physical volume 
orive_name 4 has the form <subsys>_<nn> 


Notes: This command reads the tabel of the volume on the 
specified drive namee If it is a valid ftabel for the volume 
whose name is given, the registration data is refabricated from 
the label and the drive Is teft in the known state. 
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Name: force_pd_anandon 


Function! Discard all data on fhe paging device. 


Acguments? none 


Notes: This command destroys informatlon. It should be used 
oniy after a system catastrophe which has teft pages on the 
paging device whicn cannot be flushed} and tne command should 
not be invoked until all physical volumes which can accept data 
from the paging device have been fiushed. 
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Name: saivage_dirs, salv 
Function: Salvage the airectory hierarchy. 


Syntax! saivage dirs controti_args 


Arguments? none 

Control Arguments? 
-check_vtoce Delete branch if VITOCE missing 
erebulid — Rebuiid all directorles 
-pathname Print pathname being processed 
-long -check_vtoce -rebuild -pathname 
“console Output to SYSERR console Instead of printer 
“dump Dump damaged objects 
“debug System programmer use oniy 
“-level N Saivage tevels Q-N onty 

Notes? 


The SALV card may specify some default opt lons. 
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Name? Saivage_vol, sv 
Function? Volume salvage a physical volume. 


Syotrax? Saivage_voi pvname orive name controti_largs 
salvage_vol -all control_args 


Arguments! 
pyvname is tne name of a physical volume 


drive uname nas the form <subsys>_<nn> 


Control Acguments: 


-console Output to SYSERR console Insteaa of printer 
-check_dir Delete VIOCE if no branch 

-copy ORIVE Salvage inactive copy on DRIVE 

“dump Dump damaged objects 

~debug System programmer use only 


Notes: If -alt is specified, aii Known and assumed physical 
volumes are salvaged. - , 


An accepted physical volume cannot be salvaged. 
The -copy option Ils used to Ssaivage a copy of an active volume, 
usualiy because the operator wistes to use fhe -check_dir option 


on a volume of the RLY. 


Tne SALV card may supply some default optlons. 


